Carbon


UnflattenCollectionFromHdl

Header: Collections.h Carbon status: Supported

Unflattens a collection that was flattened using the FlattenCollectionToHdl utility function.

OSErr UnflattenCollectionFromHdl (
    Collection aCollection, 
    Handle flattened
);
Parameter descriptions
aCollection

A reference to a collection object in which to store the unflattened information. The behavior of this function is undefined if you do not provide a reference to a valid collection object.

flattened

A handle to the data that was previously flattened. You must provide a valid Macintosh Memory Manager handle in this parameter.

function result

A result code.

DISCUSSION

To unflatten a collection directly from disk, use the UnflattenCollection function.

To flatten a collection to a block of memory referenced by a handle, use the FlattenCollectionToHdl function.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)